home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / dmania26.zip / DMANIA.DOC < prev    next >
Text File  |  1992-12-08  |  17KB  |  410 lines
  1.  
  2.                       ┌────────────────────────────┐
  3.                       │============================│
  4.                       │        Dollarmania!        │
  5.                       │============================│
  6.                       │    (c)1992 T&J Software    │
  7.                       └────────────────────────────┘
  8.         One of the T&J Software Collection of multi-BBS door programs.
  9.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  10.              UltraBBS, Telegard, TriBBS, Remote Access, WWIV, and
  11.                                 Digiboard
  12.  
  13.                        VERSION 2.60     12/04/92
  14.  
  15.                                    By
  16.  
  17.                                Tom Wildoner
  18.                              397 West Broadway
  19.                               Jim Thorpe, PA
  20.                                   18229
  21.                             VOICE (717)325-9480
  22.                    *between 5:30 & 10:00 p.m. Eastern Time
  23.  
  24.                                   From
  25.  
  26.                                The T&J BBS
  27.                               (717)325-9481
  28.                         1200/2400/9600/19200/38400
  29.                                24 Hours/Day
  30.  
  31. LATEST VERSION:
  32. ===============
  33.  
  34. Please call the T&J BBS for the latest version of this program.
  35.  
  36. LEGALITIES:
  37. ===========
  38.  
  39. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  40. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  41. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  42. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  43. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  44. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  45.  
  46. DISTRIBUTION:
  47. =============
  48.  
  49. You may make this file available for downloading from your BBS or you may
  50. upload it to any BBS of your choice, provided that you do not make any
  51. changes to the contents of the archive (ZIP file). The archive and its
  52. individual contents may not be used by any service that charges any money
  53. whatsoever, without the written permission of the author.
  54.  
  55. PROGRAM DESCRIPTION:
  56. ====================
  57.  
  58. Dollarmania! is a simple slot machine door program -- players can enter
  59. from one to ten coins (in STANDARD mode) or any dollar amount thet
  60. want (in CUSTOM mode). The two modes are sysop configurable in the
  61. SETUP sub-program. Online help, payoff tables and the alltime high
  62. scorer information is available while the user is in the door. The
  63. jackpot, player starting money and number of attempts per day is all
  64. sysop configurable!
  65.  
  66. At the conclusion of play, the door also creates a top ten score file,
  67. both color and mono. The door resets automatically every Monday with
  68. the help of a maintenance program which is built-in to the main
  69. Dollarmania! program.
  70.  
  71. The jackpot increases $5 per play when setup in the STANDARD mode and
  72. $100 per play when setup in the CUSTOM mode.
  73.  
  74. If the users spends all of his/her money, he cannot play again until
  75. Monday when the door resets!
  76.  
  77. NOTE:
  78. =====
  79.  
  80. The DMANIA.KEY file that is distributed with this door does NOT expire!
  81. This is simply here so the door has a KEY to read. When you register,
  82. you will receive a new DMANIA.KEY file.
  83.  
  84. Your users will only be allowed 10 attempts per day until the door is
  85. registered.
  86.  
  87. Running the door locally (DMANIA LOCAL) will let you evaluate the
  88. door with no crippling effects. You get the total turns that you have
  89. the door configured for.
  90.  
  91.  
  92. FEATURES:
  93. =========
  94.            --- Desqview Aware.
  95.            --- COM1-4 support and non-standard IRQ's.
  96.            --- Colorful ANSI screens.
  97.            --- Chat function.
  98.            --- NO BRUN module needed for play.
  99.            --- BETA tested on five different boards.
  100.            --- Will return to BBS on dropped carrier.
  101.            --- Will TIMEOUT a player after 5 minutes of no activity.
  102.            --- Use of HOT KEYS while in the door.
  103.            --- Support BBS available.
  104.            --- STANDARD and CUSTOM mode available.
  105.            --- The jackpot is progressive.
  106.            --- A log file that shows who entered the game.
  107.  
  108.  
  109. INSTALLATION: (using the DMANIA SETUP command)
  110. ===============================================
  111.  
  112. Run Dollarmania! using the command string SETUP (i.e.  DMANIA UTILITY)
  113.  
  114.      Just type:  DMANIA UTILITY
  115.  
  116. You will be presented with five options:
  117.  
  118.     1.] Reset the door.
  119.     2.] Setup your DMANIA.CFG file.
  120.     3.] Setup your SYSOP.CFG file.
  121.     4.] Reset the ALLTIME high score file.
  122.     5.] Quit.
  123.  
  124. Let's start with number one and reset the entire door from scratch!
  125.  
  126. Now, select number two to setup the DMANIA.CFG file. Just answer all
  127. the questions that are presented.
  128.  
  129. Now, select number three to setup your SYSOP.CFG file. You will be asked
  130. the following questions:
  131.  
  132.     --- Starting jackpot amount.
  133.     --- Number of tries per day.
  134.     --- Starting cash.
  135.     --- CUSTOM or STANDARD mode.
  136.     --- PATH to color bulletin.
  137.     --- PATH to mono bulletin.
  138.  
  139. These are further explained in the UTILITY sub-program.
  140.  
  141.  
  142. CONFIGURATION:
  143. =============
  144.  
  145. Example configuration file for PCBOARD.SYS
  146. ------------------------------------------
  147.  
  148. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  149. T&J Software        <=-  (Change this to your BBS name)
  150. Tom                 <=-  (The Sysop's first name)
  151. Wildoner            <=-  (The Sysop's last name)
  152.  
  153. Example configuration file for USERS.SYS
  154. ----------------------------------------
  155.  
  156. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  157. T&J Software        <=-  (Change this to your BBS name)
  158. Tom                 <=-  (The Sysop's first name)
  159. Wildoner            <=-  (The Sysop's last name)
  160.  
  161. Example configuration file for DOOR.SYS
  162. ---------------------------------------
  163.  
  164. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  165. T&J Software        <=-  (Change this to your BBS name)
  166. Tom                 <=-  (The Sysop's first name)
  167. Wildoner            <=-  (The Sysop's last name)
  168.  
  169. Example configuration file for USERINFO.DAT
  170. -------------------------------------------
  171.  
  172. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  173. T&J Software        <=-  (Change this to your BBS name)
  174. Tom                 <=-  (The Sysop's first name)
  175. Wildoner            <=-  (The Sysop's last name)
  176. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  177.  
  178. Example configuration file for CALLINFO.BBS
  179. -------------------------------------------
  180.  
  181. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  182. T&J Software        <=-  (Change this to your BBS name)
  183. Tom                 <=-  (The Sysop's first name)
  184. Wildoner            <=-  (The Sysop's last name)
  185.  
  186. Example configuration file for DORINFOx.DEF
  187. -------------------------------------------
  188.  
  189. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  190.                           where 'x' is the BBS Node number.
  191. T&J Software        <=-  (Change this to your BBS name)
  192. Tom                 <=-  (The Sysop's first name)
  193. Wildoner            <=-  (The Sysop's last name)
  194.  
  195. Example configuration file for SFDOORS.DAT
  196. ------------------------------------------
  197.  
  198. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  199. T&J Software        <=-  (Change this to your BBS name)
  200. Tom                 <=-  (The Sysop's first name)
  201. Wildoner            <=-  (The Sysop's last name)
  202.  
  203. Example configuration file for CHAIN.TXT
  204. ----------------------------------------
  205.  
  206. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  207. T&J Software        <=-  (Change this to your BBS name)
  208. Tom                 <=-  (The Sysop's first name)
  209. Wildoner            <=-  (The Sysop's last name)
  210.  
  211. Example configuration file for GTUSER.BBS
  212. -----------------------------------------
  213.  
  214. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  215. T&J Software        <=-  (Change this to your BBS name)
  216. Tom                 <=-  (The Sysop's first name)
  217. Wildoner            <=-  (The Sysop's last name)
  218. 1                   <=-  (COM port number - defaults to 1)
  219. 1                   <=-  (Node number - defaults to 1)
  220.  
  221. Example Batch File
  222. ==================
  223.  
  224. A sample batch file is included and is similer to the following:
  225.    ECHO OFF
  226.    CD\DOORS\ONLINE          <=- Switch to the door's Directory.
  227.    DMANIA DMANIA.CFG        <=- Execute the door program and pass the
  228.                                 configuration filename to the program.
  229.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  230.    BOARD                    <=- Restart BBS.
  231.  
  232.  
  233. This Door is multi-node  compatible so you may run more than 1 node from
  234. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  235. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  236. variables, (q.v.)
  237.  
  238. Normally, when running multinode, just setup different DMANIA.CFG files
  239. for each node:   DMANIA1.CFG   DMANIA2.CFG  etc....
  240.  
  241. Environment Variables
  242. =====================
  243.  
  244. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  245. variables. Non-PCBoard systems may also use these variables by including
  246. the following in either your BBS batch or AUTOEXEC.BAT
  247.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  248.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  249. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  250. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  251. .CFG file for multi-node operation!
  252.  
  253. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  254. command line.  For example:
  255.  
  256.      DMANIA DMANIA.CFG /5
  257. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  258.      DMANIA DMANIA.CFG /%IRQ%
  259.  
  260. This tells the program to use IRQ 5 instead of the standard IRQ.
  261.  
  262.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  263.  systems. Seems Novell also uses the / character so something went screwy
  264.  somewhere. So I added the * (asterisk) which may be used instead of the /
  265.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  266.  and are interchangeable.
  267.  
  268. When specifying the location of the system file on line 1 of the doors .CFG
  269. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  270. and %wcnodeid%. Some examples:
  271.  PCBoard: 
  272.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  273.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  274.  
  275.  Wildcat!:
  276.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  277.  
  278. Non-PCBoard systems may use the PCB environment variables by setting them
  279. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  280.  SET PCBDRIVE=C:
  281.  SET PCBDIR=\BBSDIR
  282.  SET PCBNODE=1
  283.  
  284. Fossil Driver Support
  285. ---------------------
  286. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  287. Fossil driver instead of the standard COM ports, just put /FD on the command
  288. line when running the door. For example:
  289.      MYDOOR MYDOOR.CFG /FD
  290. indicates that a Fossil driver is present and should be used. If no Fossil
  291. driver is detected, DoorFrame will print a message to that effect and exit
  292. the door gracefully.
  293.  
  294. Sysop Keys
  295. ==========
  296.  
  297. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  298.          written to DOOR.SYS and USERS.SYS
  299. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  300.          and/or written to DOOR.SYS and USERS.SYS
  301. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  302. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  303.          and/or written to DOOR.SYS and USERS.SYS
  304. F8    -  Returns the caller involuntarily to the BBS.
  305. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  306.          and/or written to DOOR.SYS and USERS.SYS
  307. F10   -  Activates SysOp CHAT mode within the DOOR.
  308. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  309. UP    -  Give the caller extra time while in the DOOR.  
  310. DN    -  Subtract time from the caller while in the DOOR. 
  311. HOME  -  HELP key for Status Line options.
  312. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  313. ALT-X -  PCBoard will exit after current caller logs off. Value is
  314.          passed to PCBoard. Not available on non-PCBoard systems.
  315.  
  316. PROBLEMS:
  317. ========
  318.  
  319. If any internal errors do occur, check for a file called DFRAME.ERR
  320. and let me know what the error code says.
  321.  
  322. Several people have been having problems with their Trident SVGA
  323. cards and the ANSI screens not showing up correctly. To fix this,
  324. check you utility disk that came with your Trident card for a program
  325. called TANSI.SYS or something similar. Replace your old ANSI.SYS
  326. with this version of it. This will correct the problems.
  327.  
  328. Several people have had problems running some of the doors under
  329. Livecat. Try copying your user information files to the Dollarmania
  330. sub-directory and then telling Dollarmania to look for them there.
  331. Add something like this to beginning of your door batch file:
  332.  
  333.        COPY C:\WC30\WCWORK\NODE1\DOOR.SYS C:\WC30\DOOR\DMANIA
  334.  
  335. Don't forget to change line one in your DMANIA.CFG file to reflect
  336. the new location of the DOOR.SYS file.
  337.  
  338. Please feel free to contact me if you have any problems at all.
  339.  
  340. ┌──────────────────────────────────────────────────────────────────────────┐
  341. │  MAINTENANCE:                                                            │
  342. │  ===========                                                             │
  343. │                                                                          │
  344. │ Nightly maintenance is required for this door. It's needed to determine  │
  345. │ if the current day is Monday. If it is, the door will reset all the      │
  346. │ player records and the bulletins. All users will now get a fresh start.  │
  347. │ The jackpot does not get reset! The jackpot will continue to grow until  │
  348. │ somebody wins it, then it gets reset.                                    │
  349. │                                                                          │
  350. │ To run the maintenance program, just run Dollarmania with the MAINT      │
  351. │ command string as part of your nightly maintenance:                      │
  352. │                                                                          │
  353. │      --- Switch to the Dollarmania directory                             │
  354. │      --- Run --->  DMANIA MAINT                                          │
  355. └──────────────────────────────────────────────────────────────────────────┘
  356.  
  357. RUNNING LOCALLY:
  358. ===============
  359.  
  360. To run in LOCAL mode simply type DMANIA LOCAL
  361.  
  362.  
  363. UPGRADING:
  364. ==========
  365.  
  366. If you are upgrading from a previous version of Dollarmania! (before v2.5),
  367. reinstall this version from scratch. If you are upgrading from v2.5 to v2.6
  368. simply replace the DMANIA.EXE file and all the DM*.DAT files!
  369.  
  370.  
  371. FUTURE VERSIONS:
  372. ================
  373.  
  374. --->> Let me know what you would like to see added!!
  375.  
  376.  
  377. VERSION HISTORY:
  378. ===============
  379. Version 1.00 ......... First release. 01/22/92
  380. Version 1.10 ......... Corrected bug that prevented SysOp's running a
  381.                        BBS with no locked com port from using the door.
  382. Version 2.00 ......... Switched door writing code to DoorFrame.
  383.                        02/20/92
  384. Version 2.10 ......... Recompiled using newest door writing routines,
  385.                        added internal maintenance, and added new bulletins.
  386.                        04-17-1992
  387. Version 2.50 ......... Recompiled using the newest door rotuines, switched
  388.                        to an external maintenance program, added support
  389.                        for STANDARD or CUSTOM modes of play, new bulletins,
  390.                        door resets every Monday, added support to play the
  391.                        door locally with no crippling, screens updated,
  392.                        added alltime high score screen for the users to
  393.                        view. 07-02-1992
  394. Version 2.60 ......... Recompiled using the newest door routines. Screen
  395.                        now redraws itself after a drop to dos or after
  396.                        chatting with the user. The 30 something line
  397.                        version of DOOR.SYS is now supported as well as
  398.                        the 52 line version. Added support for fossil
  399.                        drivers. Added support for double digit IRQ
  400.                        numbers when used.  12-04-92
  401.  
  402.  
  403. REGISTERING:
  404. ============
  405. That's all there is to it! If you have any problems or questions
  406. please feel free to call the T&J BBS at (717)325-9481 and join the
  407. T&J Software Conference.
  408.  
  409. See the enclosed registration form for ordering!  (REGISTER.TXT)
  410.